package com.nidu.demo.menu.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.menu.model.Menu;
import com.nidu.demo.menu.model.MenuCriteria;

import java.util.Set;
import java.util.List;

/**
 * 菜单网关接口
 * 提供领域层对菜单的访问能力
 *
 * @author auto
 */
public interface MenuGateway {

    /**
     * 创建菜单
     *
     * @param menu 菜单信息
     * @return 创建后的菜单
     */
    Menu create(Menu menu);

    /**
     * 更新菜单
     *
     * @param menu 菜单信息
     * @return 更新后的菜单
     */
    Menu update(Menu menu);

    /**
     * 根据ID查询菜单
     *
     * @param id 菜单ID
     * @return 菜单信息
     */
    Menu getById(Long id);

    /**
     * 根据ID列表查询菜单
     * 
     * @param ids 菜单ID列表
     * @return 菜单列表
     */
    List<Menu> getByIds(Set<Long> ids);

    /**
     * 根据菜单名称查询菜单
     *
     * @param name 菜单名称
     * @return 菜单信息
     */
    Menu getByName(String name);

    /**
     * 查询子菜单列表
     *
     * @param parentId 父菜单ID
     * @return 子菜单列表
     */
    List<Menu> getByParentId(Long parentId);

    /**
     * 删除菜单
     *
     * @param id 菜单ID
     */
    void deleteById(Long id);

    /**
     * 批量删除菜单
     * 
     * @param ids 菜单ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 查询菜单列表
     * 
     * @param criteria 查询条件
     * @return 菜单列表
     */
    List<Menu> listByCondition(MenuCriteria criteria);


    /**
     * 查询菜单树
     *
     * @param criteria 查询条件
     * @return 菜单树
     */
    List<Menu> treeByCondition(MenuCriteria criteria);

    /**
     * 分页查询菜单
     * @param criteria 查询条件
     * @return 菜单分页
     */
    PageResponse<Menu> pageByCondition(MenuCriteria criteria);

    /**
     * 更新菜单状态
     * 
     * @param id 菜单ID
     * @param status 状态值
     */
    void updateStatus(Long id, Integer status);

}